home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
dskut
/
sutil282.zip
/
SUTIL.DOC
< prev
next >
Wrap
Text File
|
1992-11-05
|
25KB
|
525 lines
------------------------------------------------------------------------------
11/05/92 Supreme Utility All Rights Reserved
Copyright (c) 1990-92 by SupremeSoft Integrated Copy/Move/Delete/Rename
------------------------------------------------------------------------------
Version 2.82
Supreme Utility is a command line based program which allows you to
Copy, Delete, Rename and Move files all in one operation. Imagine begin able
to delete all your BAK files while at the same time copying all your DOC
files to your word processing directory!
Supreme Utility can work locally or globally. That is, it can
manipulate files in only the current directory, or on the entire disk.
Naturally you are in complete control at all times, unless you choose not to
be. Here is the calling syntax: ( [] indicates optional items)
SUtil [-|/][Gflags] [-|/][mdcrx] filelist [,filelist] [-|/][flags] [@filen] ..
The ".." indicates that you may include more combinations of commands/flags
in the same form as specified earlier.
Where: m = move these files
d = delete these files
c = copy these files
r = rename these files
x = exclude these files (See excluding files below)
Flags are: h = use hidden/system files as well (Off by default)
g = work on the entire disk (Off by default)
p = disable prompting (On by default)
q = quiet mode (Off by default)
e = check exclude list (Default depends)
s = scan subdirectories (Off by default)
k = check free disk space (Off by default)
@filen: Indicates a file consisting of operations to be read in.
(filen = any valid DOS filename, including leading path)
A filelist consists of a list of filenames, as many as you want. If you do
not explicitly specify a second filelist using the "," separator, the last
filename in the file list is taken as the target (if appropriate). (See
"Oddities" below)
[-|/] indicates you may use either a "-" or a "/". These are commonly
referred to as the "switch" characters.
Each operation (m,d,r, c, or x) MUST be preceded by a switch, and each flag
(H, G, P, Q, E, S, K) MUST be preceded by a switch.
Case is insignificant, i.e., M = m, C = c, H=h, etc.
GFlags are flags which are set as defaults for all operations. If you
specify any flags after certain commands, they will then override the default
flags set in GFlags for that operation only.
Flags may appear anywhere on the command line, except between filename
lists. If you override a default flag, it will return to its default after
the operation completes. Use GFlags to set/reset defaults.
Quiet mode will turn off the file exists warning, thereby proceeding with
the operation and overwriting any existing files.
If a "," is included between filename lists, the filenames FOLLOWING the
"," will be used as new target names. (See below for further information)
Filenames may consist of a leading path, and any DOS wildcards.
NOTE!: A DOS wildcard of *?????, that is a star (*) anywhere in the
wildcard, will match ALL files, regardless of what follows, or
precedes the * indicator. See ODDITIES for more information.
Each command may have any number of filenames following it.
You may use multiple @filen specifications if you wish.
Ctrl-Break/Ctrl-C will abort the program.
DOS ERRORLEVEL is set for batch file testing. The following are the
possible return codes:
0 Success
1 Help was activated (no command line)
2 Fatal error, program aborted
3 Out of memory error
Use the DOS environment variable SUTIL to set initial operations. The syntax
is: SET SUTIL = [operations]
If you choose the Sub-directory option, Supreme Utility will scan all
subdirectories of the CURRENT directory for matching files. Any leading path
identifiers are ignored. If you issue the Global option, then this option will
be ignored.
Choosing the /K switch will slow down operations somewhat at the start, but
can save time in the long run since SUtil will not attempt the operation if
there is not enough disk space. If you do NOT choose this switch and there
is NOT enough disk space, SUtil will only abort after it detects the error.
When using the /K switch and performing operations on the same drive,
SUtil is smart enough to determine if there is a need to check the free
disk space. If there is not, then it will not do so. This is why it is wise
to make the /K switch part of your GFlag setting.
-----------------------------------------------------------------------------
Moving files:
To move files, use the -m or /m option and specify the files to be
moved. You do not have to specify the target directory as long as the files
to be moved are not in the current directory. If you leave prompting active,
you will be asked to confirm each move.
The target directory cannot be the current directory, but can be
anything else, including another drive/directory combination. The files will
be moved extremely quickly, though drive to drive moves will take longer
depending on the drive types.
You may also specify that the files be named differently by
specifying a path/filename combination. See Example5.
The date/time stamp on the source file will be preserved on the
target file. In other words, the date/time stamp on the target file will
be the same as on the source file.
Example1: SUtil /m test.bak test.doc \temp /p
Does : Moves "test.bak" and "test.doc" to the "\temp\" directory, and
does not prompt you for verification.
Example2: SUtil -m \temp\*.bak \docs\test.doc \tt.doc
Does : Moves all BAK files from the "\temp\" directory, "test.doc"
from the "\docs\" directory, "tt.doc" from the root to the CURRENT
directory.
Example3: SUtil /m *.bak \junk\ /h /g /q
Does : Moves all BAK files on the ENTIRE disk to the "\junk\" directory,
and this will also move BAK files which are marked as
Hidden/System. In addition, if any of the files exist in the
target directory, they are overwritten automatically.
Example4: SUtil -m \temp\*.bak /g
Does : Will move all BAK files from the "\temp\" directory to the CURRENT
directory, and will then attempt to find any further "\temp\*.bak"
files on the disk. Since there will be no more, nothing further is
done.
Example5: SUtil -m myfile.tst hey.me,\test\junk.tst \test\hey.tst /p/h
Does : Will move "myfile.tst" to "\test\junk.tst" and "hey.me" to
"\test\hey.tst". No prompting is done, and hidden files are moved.
Example6: Sutil -m *.pas, *.bak /p
Does : Moves all PAS files in the current directory to BAK files in the
current directory. You are not prompted.
(This is essentially the same as a rename)
Remember, you cannot move files in the current directory to the
current directory unless you specify a new target name. The program will
issue an error message if you attempt to move into the same
directory using the same name.
-----------------------------------------------------------------------------
Deleting Files:
To Delete files use the -d or /d option. If you leave prompting on,
you will be asked to confirm each delete.
Example1: SUtil -d *.bak *.txt /p
Does : Deletes all BAK files and all TXT files in the current directory,
but does not ask you to verify the delete(s).
Example2: SUtil /d *.bak /g /p
Does : Deletes all BAK files on the entire disk. Even though prompting is
off, you will be as